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IMPORTANT: READ BEFORE INSTALLATION 

• If, when Much"' 30 is first booted, after tire message 

root on fdO 

r > 

is printed, die following error occurs: 

fdO: Illegal format type 

followed (eventually) by a panic, then your floppy controller can not handle the method used by the 
Mach 386 floppy driver to determine the format of the floppy. This means that you have to inform the 
driver of the correct fomiat. See the final entry on the buglist below. 


BUGLIST 

• We do not distribute mh, but we do distribute Xmh. If you run Xmh without having mh. you get the 
error: 

Xmh: err 2 unrecognized file or directory 
execvp failed 

Sources to mh are available from UUNET. Via anonymous ftp they’re in the mail directory (as of 
tills writing, in file mh- 6.7 . tar. Z). 

• For programs with very large data space usage, do not set datasize limit to be unlimited. Instead, just 
set it to be high (e.g., 64 Mb). 

• uncompress, if given more than one file on tne command line (e.g. uncompress *. z) may corrupt 

some of its output. It will uncompress tiles one at a time without error. * 

• If running nfs via the 3Com 501 or 502 ethemet board, you will have to use the rsize and wsize 
options of value 512 for any NFS mounts to or from your Mach ° machine. 

• The /usr/adm/aculog file is not distributed with Mach386, but it is used by tip (1) to keep track cf 
outgoing calls. Running tip produces the error can't open log file /usr/adm/aculog. No 
other tip operations are affected by this error. If you want to keep track of outgoing calls, create 
/usr/adm/aculog, owned and/or writable by uucp. If you don't want to keep track of outgoing 
calls, but are annoyed by the error message from iip( 1), you may create a symbolic link for 
/usr/adm/aculog pointing to /dev/null. 

• Running iostat to get disk performance statistics produces the error Disk inic info not in 
namelist. The iostat(l) program has not been ported to the 386. 

• ftp silendy crops passwords at 8 characters before sending them to die remote ftp daemon. If that dae¬ 
mon is on a system that normally encrypts long passwords hi their entirety, die ftp{ 1) user will not be 
able to access that system. 

• Opening a socket in the filesystem causes a kernel panic, as in 

echo hello > /dev/printer 

• In using the pn=@ field for /etc/remote, if /etc/phones is NOT readable ny the world and vou 
are not root, then tipi 1) will complain that it cannot open /etc/phones. You can work around this 
by making it world readable, which defeats the security purpose of using the /etc/phones file. 

• Acucntrl doesn’t handle the /etc/ucmp file properly (doesn’t examine or set die correct entry 
number). 



In the C-Shell, if you cd /, then ad . then cd to any directory name that doesn’t start with /, the 
shell will terminate with an abort (5), creating a core tile (if you have permission to write into /). 

eval 'resize ' does not work in the C-Shell. 

The xcltn( 1) program in the X-Windows Base component dumps core. 

In the directory /usr/local/gnu/lib/emacs/etc, DOC is a symbolic link to a non-existant file. 
It should be a link to DOC-18.55.6 in the same directory. 

The following steps will have to be taken to successfully bootstrap Mach 386 if your floppy controller 
cannot handle the method used by the Mach 386 floppy driver to determine the format of the floppy. 
When the (replacement) boot floppy is booted and prints Boot::, type -as. After the filesystem is 
inserted and the bootup messages are printed, the kemei will stop and ask for a Root device?, to 
which you answer fdOd, if you are running on 5.25” floppies, or fdOb for 3.5” floppies. 

After booting, and when the # prompt appears, you will need to change the device node files in /dev 
on the filesystem. The device files that get installed on the hard disk will also need to be changed - 
more on that below. Here is the sequence of commands for the filesystem floppy: 

# cd /dev 

# m *fd* *flop* 

# ./MAKEDEV fd0.3 (for 5.25” floppies) 

or 

# ./MAKEDEV fdO.l (for 3.5” floppies) 

Once you have made these changes, type sync and then halt -1 -q to halt the machine. When 
you reboot, this time (and every subsequent time the system is brought up on the floppy) type -a to 
the Boot : prompt. Fsck may still find an error, but it should fix it and reboot without incident. 

When you get to step 1.3.3 in the installation sequence (page SMM 1:1-3), after booting, you will prob¬ 
ably get some more Illegal format messages and the error messages 

Can't mount bootstrap floppy to extract kernel 
Please insert Bootstrap floppy and press <Return> 

Type <Control>-C at that point and wait for the # prompt. You can then do the same sequence as 
above to change the floppy device. After doing that sync the filesystem again, then run 
rc. install. Hopefully, everything will go much smoother after all this. 

Once the system is installed, you may need to replace the device files for the second floppy drive in 
order to use that one. Use the MAKEDEV script with the argument fdl. 1 for a 3.5” floppy drive, or 
fdl. 3 for a 5.25” drive. 



